home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / utility / utilmisc / dlstlrt3.lh0 / DaLastAlert3 / Doc / DaLastAlert3.doc next >
Text File  |  1996-12-29  |  14KB  |  476 lines
  1.  
  2.  
  3.  
  4.  
  5.                        DaLastAlert 3 User Manual
  6.  
  7.          Copyright (C) 1996 Jørgen 'Da' Larsen (Posse Pro. DK)
  8.  
  9.  
  10. DaLastAlert 3
  11. **************
  12.  
  13. Introduction
  14. ============
  15.  
  16.    Are you tired of always having troubles with finding your pen and
  17. paper just to write down the last guru you got?  Now this problem is
  18. solved because I have written a 'small' and quick program that will
  19. show not only the last guru, but also a nice hint to what caused it!
  20.  
  21.    If you don't get the point of what this program can be used to then
  22. try to read the section What AS wrote about LA2.
  23.  
  24.  
  25. Copyright
  26. ==========
  27.  
  28.    This utility is released as FREEWARE.  This means that the program,
  29. and this user manual etc.  (the distribution) are freely distributable,
  30. but are also Copyright (c) Jørgen 'Da' Larsen.  The distribution must
  31. be kept together and there must only be charged a nominal fee to cover
  32. time and copying costs. Please also remember that no commercial usage
  33. is permitted without written permission from the author.
  34.  
  35. The distribution consists of:
  36.  
  37.      * DaLastAlert3              - Main program
  38.      * DaLastAlert3.info         - Icon
  39.      
  40.      * DaLastAlert3-Check        - Starter program
  41.      * DaLastAlert3-Check.info   - Icon
  42.      
  43.      * DaLastAlert3.alerts       - Alerts (textfile)
  44.      
  45.      * DaLastAlert3.guide        - Documentation in AmigaGuide© format
  46.      * DaLastAlert3.guide.info   - Icon
  47.      * DaLastAlert3.texinfo      - Documentation in TeXinfo format
  48.      * DaLastAlert3.texinfo.info - Icon
  49.      * DaLastAlert3.doc          - Documentation in ASCII format
  50.      * DaLastAlert3.doc.info     - Icon
  51.      
  52.      * DLA3.pic                  - Example Picture
  53.      * DLA3.pic.info             - Icon
  54.      
  55.      * Install-script            - Installer script
  56.      * Install.info              - Installer icon
  57.  
  58.  
  59. Disclaimer
  60. ===========
  61.  
  62.    The author is in no way liable for any changes made to any part of
  63. the package, or consequences thereof as he is in no way liable for
  64. damages or loss of data directly or indirectly caused by this software.
  65.  
  66.  
  67. System Requirements
  68. ====================
  69.  
  70.    DaLastAlert 3 requires Kickstart and Workbench 2.0 or higher to run!
  71.  
  72.  
  73. Installation
  74. =============
  75.  
  76. Just press the installer icon:
  77.  
  78.    * Install
  79.  
  80.    Please notice that the program can be installed anywhere you want,
  81. but please read Usage if you want my opinion (This is also the default
  82. in the chosen installer scripts) where DaLastAlert 3 would have it's
  83. best place.
  84.  
  85.  
  86. Usage
  87. ======
  88.  
  89. DaLastAlert3
  90. ------------
  91.  
  92.    The program can either be started from Workbench (just click the
  93. icon) or from CLI/Shell with the command:
  94.  
  95.      DaLastAlert3 [G=GURUNUMBER] [H=HELP/S] [N=NOGUI/S]
  96.      
  97.      Examples: > DaLastAlert3
  98.      
  99.                > Will popup - see picture below
  100.      
  101.      
  102.        or      > DaLastAlert3 $80000005
  103.      
  104.                > Will popup as above and show the below just in a juicy GUI
  105.      
  106.      
  107.        or      > DaLastAlert3 $80000005 NOGUI
  108.      
  109.                > DaLastAlert v3.0d (c) 1996 Jørgen 'Da' Larsen (Posse Pro. DK)
  110.                > Alert Number: $80000005
  111.                > Alert Task:   Unknown
  112.                > Alert Name:   ACPU_DivZero
  113.                > Spec. Alert:  Divide by zero
  114.                > Spec. Error:  Hardware/CPU
  115.      
  116.      
  117.        or      > DaLastAlert3 HELP
  118.      
  119.                > DaLastAlert v3.0d (c) 1996 Jørgen 'Da' Larsen (Posse Pro. DK)
  120.                > Syntax: DaLastAlert [G=GURU] [N=NOGUI] [H=HELP]
  121.                > Try:    DaLastAlert $80000004
  122.                >  or     DaLastAlert $80000004 NOGUI
  123.      
  124.      
  125.         +------------------------------------------------------------+
  126.         | | DaLastAlert 3                                          | |
  127.         +------------------------------------------------------------+
  128.         |                                                            |
  129.         | Alert Number :  0x80000005                                 |
  130.         | Alert Task   :  0x0800DDE8                                 |
  131.         |  -------------------------------------------------------   |
  132.         | Alert Name   :  ACPUG_DivZero                              |
  133.         | Spec. Alert  :  Hardware/CPU                               |
  134.         | Spec. Error  :  Divide by zero                             |
  135.         |                                                            |
  136.         |------------------------------------------------------------|
  137.         |                 _________________________________________  |
  138.         | Alert Number : |_________________________________________| | -+
  139.         |                                                            |  |
  140.         |------------------------------------------------------------|  |
  141.         |                                                            |  |
  142.         |      About              Last alert            Quit         |  |
  143.         |                                                            |  |
  144.         +------------------------------------------------------------+  |
  145.                  |                    |                  |              |
  146.                  |                    |                  |              |
  147.          Show ---+       Shows the ---+          Quit!---+     Input ---+
  148.          about           last alert                            string
  149.          requester       again
  150.  
  151.    DaLastAlert3 also reads ENV:DaLastAlert that tells DaLastAlert3
  152. where look for the textfile that contains the alert descriptions
  153. (Default: 'S:DaLastAlert3.alert').
  154.  
  155. Note
  156. ----
  157.  
  158.    The alert number shown by pressing 'Last alert' will of course be
  159. meaningless if you haven't had any Software failure's since you turned
  160. your system on.
  161.  
  162. DaLastAlert-Check
  163. -----------------
  164.  
  165.    If you can't get a postive reaction from DaLastAlert-Check it's
  166. probably because you haven't had a Guru/Software failure lately.  If
  167. you have had a Guru/Software failure then the string defined as EXEC
  168. will be executed.
  169.  
  170.    The program can either be started from Workbench (just click the
  171. icon) or from CLI/Shell. The options are as follows:
  172.  
  173.      WB Options
  174.      
  175.      EXEC - Where to find DaLastAlert3
  176.      
  177.      Example:  > EXEC=sys:Utilities/DaLastAlert3  (This is also the default)
  178.      
  179.      
  180.      CLI Options
  181.      
  182.      DaLastAlert3-Check [EXEC]
  183.      
  184.      Examples: > DaLastAlert3-Check
  185.      
  186.                > Executes sys:Utilities/DaLastAlert3
  187.      
  188.      
  189.        or      > DaLastAlert3-Check c:DaLastAlert3
  190.      
  191.                > Executes c:DaLastAlert3
  192.  
  193.    My suggestion to make DaLastAlert 3 as efficient as possible will be
  194. to place DaLastAlert3-Check in the WBStartup drawer (or maybe in the
  195. Startup-sequence) as this will allow you to recieve information on the
  196. last guru.
  197.  
  198.    If you follow my suggestion you will be free from troubles, like
  199. where's my pen and I am out of paper, every time a guru pops up.
  200.  
  201.  
  202. Bugs
  203. =====
  204.  
  205.    DaLastAlert 3 have been tested on these configurations:
  206.  
  207. `Amiga 2000'
  208.      A2000, GVP G-Force 030 50MHz, MMU, FPU
  209.  
  210. `Amiga 1200'
  211.      2 MB CHIP.
  212.  
  213. `Amiga 1200'
  214.      MBX1200Z, 2 MB CHIP, 4 MB FAST.
  215.  
  216. `Amiga 1200'
  217.      BLIZZARD 1220/4 28.5MHz, NO FPU, 2 MB CHIP, 4 MB FAST.
  218.  
  219. `Amiga 1200'
  220.      M1230XA 40MHz, NO MMU, NO FPU, 2 MB CHIP, 8 MB FAST, Overdrive HD.
  221.  
  222. `Amiga 1200'
  223.      M1230XA 50MHz, MMU, FPU, 2 MB CHIP, 8 MB FAST, EzDrive, CD-Rom
  224.      (My Amiga).
  225.  
  226.    I cannot find any (more) bugs in DaLastAlert 3 but i am sure you
  227. can. If you find a bug PLEASE fillout the bugreport formular below
  228. (orginal made by Dave Haynie) and send it to me (see About for address).
  229.  
  230. Bugreport
  231. ---------
  232.  
  233.      Your Configuration:
  234.      
  235.        [] A500     []A1000     []A2500      []A1200      []CDTV/CD32
  236.        [] A600     []A2000     []A3000      []A4000      []Other
  237.      
  238.        KS Version___________   RAM__________   Other HW__________________
  239.      
  240.        WB Version___________   HD___________   HD Controller_____________
  241.      
  242.      Please explain the problem as completely as possible:
  243.      
  244.        File System Version/Type__________________________________________
  245.      
  246.        ScreenMode________________________  Font__________________________
  247.      
  248.        []Shell/CLI     []Workbench         Locale________________________
  249.      
  250.        Problem:   []Full Lockup    []GURU/Crash
  251.      
  252.        Steps to see this problem?________________________________________
  253.      
  254.        __________________________________________________________________
  255.      
  256.        __________________________________________________________________
  257.      
  258.      
  259.        Other Comments____________________________________________________
  260.      
  261.        __________________________________________________________________
  262.      
  263.        __________________________________________________________________
  264.      
  265.      
  266.        Bug found by (address)____________________________________________
  267.      
  268.        __________________________________________________________________
  269.      
  270.        __________________________________________________________________
  271.  
  272. Note
  273. ----
  274.  
  275.    If you have Enforcer active while running DaLastAlert 3 you will get
  276. some 'Enforcer Hits' because DaLastAlert 3 makes LONG-READs at $100 and
  277. $104.( This is no BUG :P ).
  278.  
  279.  
  280. Program History
  281. ================
  282.  
  283. Version 1.0
  284. -----------
  285.  
  286.    * First release. (And it works on Kickstart and Workbench 3.0)
  287.  
  288.    * Only tested on a A1200 with different configurations with Kickstart
  289.      and Workbench 3.0
  290.  
  291. Version 2.0
  292. -----------
  293.  
  294.    * Now LastAlert also shows: Alert Number, Alert Task, Alert Name,
  295.      Spec. Alert, Spec. Error.
  296.  
  297.    * Still not tested on a Kickstart and Workbench 2.0 system!
  298.  
  299. Version 2.1
  300. -----------
  301.  
  302.    * First public release (Aminet).
  303.  
  304.    * A little bug fixed !!!
  305.  
  306. Version 3.0a
  307. ------------
  308.  
  309.    * Only released to two ßetatesters.
  310.  
  311.    * Changed the name from LastAlert to DaLastAlert.
  312.  
  313.    * Totally rewritten code (Now using Amiga E by Wouter van
  314.      Oortmerssen).
  315.  
  316.    * Now two programs.
  317.  
  318.         * A small starter program (DaLastAlert3-Check).
  319.  
  320.         * A 'big' main program (DaLastAlert3).
  321.  
  322.    * Now with a totally cool GUI (EasyGUI - Wouter van Oortmerssen).
  323.  
  324.         * Totally Font-Sensitive.
  325.  
  326.         * Resizable.
  327.  
  328.         * Etc.
  329.  
  330.    * And loads of other stuff....
  331.  
  332. Version 3.0b
  333. ------------
  334.  
  335.    * Added an alert file (S:DaLastAlert3.alerts).
  336.  
  337.    * Added an environment var. (ENV:DaLastAlert3).
  338.  
  339.    * Cleanedup source code.
  340.  
  341.    * Made Error-handling better (PrintF->EzReq).
  342.  
  343.    * Minor GUI design error corrected (COLS->EQCOLS).
  344.  
  345.    * Added requester titles.
  346.  
  347.    * Changed About text.
  348.  
  349. Version 3.0c
  350. ------------
  351.  
  352.    * First Public Release of DaLastAlert 3 (Aminet).
  353.  
  354. Version 3.0d
  355. ------------
  356.  
  357.    * Second Public Release of DaLastAlert 3 (Aminet).
  358.    * Updated the GUI and the GUI-Handling (EasyGUI v3.3a.1)
  359.    * Changed my address - yes, i get around :)
  360.  
  361.  
  362. About
  363. ======
  364.  
  365. Address
  366. -------
  367.  
  368.    If you want to contact the author of this program then write to this
  369. address:
  370.  
  371.                  Mail:   Jørgen 'Da' Larsen (Posse Pro. DK)
  372.                          Ryesgade 57, 3.TH
  373.                          9000 Aalborg
  374.                          Denmark
  375.      
  376.                  E-mail: dapp@cs.auc.dk
  377.  
  378. Or try my WWW-Homepage:
  379.  
  380.                  URL:    http://www.cs.auc.dk/~dapp/
  381.  
  382. Note
  383. ----
  384.  
  385.    Please write if you have some remarks, suggestions or if you have
  386. found some bugs in the program (you are also welcome to send me a
  387. modem, bike, car, house or maybe just a note saying that you like
  388. the program).
  389.  
  390. Credits
  391. -------
  392.  
  393. `Søren Staun-Pedersen'
  394.      ßetatester.
  395.  
  396. `Claus Nyhus Chr.'
  397.      ßetatester
  398.  
  399. `Anders F.'
  400.      ßetatester
  401.  
  402. `Wouter van Oortmerssen'
  403.      Amiga E, EDBG, EasyGUI....
  404.  
  405. Greetings ( Randomized )
  406. ------------------------
  407.  
  408.    * Søren Staun-Pedersen - No 'REAL' computer!!
  409.  
  410.    * Claus Nyhus Chr.     - Get E'ing
  411.  
  412.    * Anders S. Elkjær     - NO computer ehh!!
  413.  
  414.    * Anders F.            - I am waiting for the MegaDemo II
  415.  
  416.    * Mogens C. Larsen     - Amiga Power!!!!!
  417.  
  418.    * Flemming Kjær Jensen - Always the MAC
  419.  
  420.    * Frank 'Dux' Busborg  - Amosazing
  421.  
  422.    * Jens K. Jensen       - Party on ..
  423.  
  424.    * Esben S. Omething    - Hello!!
  425.  
  426.    * Yeko                 - Hold the line!!
  427.  
  428.    * Frostie              - JOE 'Tekkno Sumpen'
  429.  
  430.    * Preben Nielsen       - What a cruel asm coder!!
  431.  
  432.    * Bent D. Olsen        - Thanks for your letter
  433.  
  434.    * SuperTrade DK        - The 'best' Amiga shop - Yo Alex H.
  435.  
  436.    * Amiga Shopper        - Great inspiration, testing LA2
  437.  
  438.    * +ALL AMIGA OWNERS
  439.  
  440.  
  441. What Amiga Shopper wrote about LastAlert2
  442. ==========================================
  443.  
  444.    Amiga Shopper wrote the following about LastAlert2 in issue 46
  445. (February 1995):
  446.  
  447.                               ----------
  448.  
  449. From Subscripers coverdisk description:
  450.  
  451.    "LastAlert2 is very useful utility indeed.  It will tell you the
  452. Guru number of your machine after it has crashed.  Once the folder has
  453. been unarchived double-click on the install icon and the files will be
  454. copied to the appropriate directories. By default LastAlert2 will be
  455. copied to your WBStartup drawer. This means that if you machine crashes
  456. the program will be run as soon as the machine resets. It will produce
  457. a requester that informs of number the offending Guru."
  458.  
  459.                               ----------
  460.  
  461. From inside the magazine on page 78:
  462.  
  463.    "If there is one thing that is guaranteed to turn even the most sane
  464. Amiga-user into to an irrational, salivating wild beast it's a system
  465. crash. When this happens it's a good idea to make a note of the guru
  466. number that is flashed on screen. Unfortunately the average human is
  467. unlikely to be in a state of mind that will facilitate the execution of
  468. such a complex action. During these moments of debilitating rage you
  469. will certainly benefit from a program like LastAlert2.
  470.  
  471.    LastAlert2 is a Wb2+ program that will record the last message
  472. displayed by you machine. This will give you the opportunity to take
  473. note of this number while you are in a more... chemically balanced
  474. state-of-mind."
  475.  
  476.